.. _cmlAiGetVoltRangeMode:

cmlAiGetVoltRangeMode
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlAiGetVoltRangeMode([in] VT_I4 BoardID, [in] VT_I4 Axis, [in] VT_I4 Channel, [out] VT_PI4 RangeMode )                       

DESCRIPTION
`````````````  

- cmlAiGetVoltRangeMode 함수는 설정된 전압 범위에 해당하는 모드를 반환 합니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis: 사용자가 제어하고자 하는 축 혹은 노드마스터 ID 번호 
 
▶ Channel : 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 
최대 통합 채널수 - 1 이하의 값을 채널 번호로 설정할 수 있습니다. 
 
▶ RangeMode : 전압 범위 설정 모드를 설정 혹은 설정상태를 반환합니다. 전압 범위 설정 모드는 다음과 
같습니다.

.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0[Default], -10V ~ 10V 
    1, -5V ~ 5V 
    2, -2.5V ~ 2.5V 
    3, 0V ~ 10V ( 0 ~ 20mA : 전류 모드 사용 시 ) 
    4, 0V ~ 5V 
    5, 1V ~ 5V 
    6, 1V ~ 5V ( 4 ~ 20 mA : 전류 모드 사용 시) 

.. warning:: 
    0~6번 모드 모두 전압 모드로 사용할 수 있으나, 전류 모드 사용 시 3번 또는 6번 모드로 설정하셔야 합니다.


RETURN VALUE
`````````````
.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    음수, 수행 실패
    0(ERR_NONE), 수행 성공


EXAMPLE
```````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink2_SDK_Def.h” 
    #define AI_CHANNEL  5 
    Long BoardID = 0; 
    long nVoltRangeMode = 0;  
    // 5번 채널의 전압 범위 모드를 3( 0V ~ +10V )로 설정합니다. 
    if(cmlAiSetVoltRangeMode (BoardID, 3,  AI_CHANNEL, 3 ) != ERR_NONE ) 
    { 
    OutputDebugString ( " cmlAiSetVoltRangeMode function Fail" ); 
    } 
    // 5번 채널에 설정된 전압 범위에 해당하는 모드를 반환합니다. 
    if(cmlAiGetVoltRangeMode (BoardID, 3, AI_CHANNEL, &nVoltRangeMode) != ERR_NONE ) 
    { 
    OutputDebugString ( " cmlAiGetVoltRangeMode function Fail" ); 
    }